<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>char_threshold [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_segmentation.html">分割</a> / <a href="toc_segmentation_threshold.html">阈值</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">char_threshold</span><span data-if="c" style="display:none;">char_threshold</span><span data-if="cpp" style="display:none;">CharThreshold</span><span data-if="dotnet" style="display:none;">CharThreshold</span><span data-if="python" style="display:none;">char_threshold</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">char_threshold</span><span data-if="c" style="display:none;">char_threshold</span><span data-if="cpp" style="display:none;">CharThreshold</span><span data-if="dotnet" style="display:none;">CharThreshold</span><span data-if="python" style="display:none;">char_threshold</span></code> — Perform a threshold segmentation for extracting characters.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>char_threshold</b>(<a href="#Image"><i>Image</i></a>, <a href="#HistoRegion"><i>HistoRegion</i></a> : <a href="#Characters"><i>Characters</i></a> : <a href="#Sigma"><i>Sigma</i></a>, <a href="#Percent"><i>Percent</i></a> : <a href="#Threshold"><i>Threshold</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>char_threshold</b>(const Hobject <a href="#Image"><i>Image</i></a>, const Hobject <a href="#HistoRegion"><i>HistoRegion</i></a>, Hobject* <a href="#Characters"><i>Characters</i></a>, double <a href="#Sigma"><i>Sigma</i></a>, double <a href="#Percent"><i>Percent</i></a>, Hlong* <a href="#Threshold"><i>Threshold</i></a>)</code></p>
<p>
<code>Herror <b>T_char_threshold</b>(const Hobject <a href="#Image"><i>Image</i></a>, const Hobject <a href="#HistoRegion"><i>HistoRegion</i></a>, Hobject* <a href="#Characters"><i>Characters</i></a>, const Htuple <a href="#Sigma"><i>Sigma</i></a>, const Htuple <a href="#Percent"><i>Percent</i></a>, Htuple* <a href="#Threshold"><i>Threshold</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>CharThreshold</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, const HObject&amp; <a href="#HistoRegion"><i>HistoRegion</i></a>, HObject* <a href="#Characters"><i>Characters</i></a>, const HTuple&amp; <a href="#Sigma"><i>Sigma</i></a>, const HTuple&amp; <a href="#Percent"><i>Percent</i></a>, HTuple* <a href="#Threshold"><i>Threshold</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>::<b>CharThreshold</b>(const HRegion&amp; <a href="#HistoRegion"><i>HistoRegion</i></a>, double <a href="#Sigma"><i>Sigma</i></a>, const HTuple&amp; <a href="#Percent"><i>Percent</i></a>, HTuple* <a href="#Threshold"><i>Threshold</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>::<b>CharThreshold</b>(const HRegion&amp; <a href="#HistoRegion"><i>HistoRegion</i></a>, double <a href="#Sigma"><i>Sigma</i></a>, double <a href="#Percent"><i>Percent</i></a>, Hlong* <a href="#Threshold"><i>Threshold</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>CharThreshold</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, <a href="HObject.html">HObject</a> <a href="#HistoRegion"><i>histoRegion</i></a>, out <a href="HObject.html">HObject</a> <a href="#Characters"><i>characters</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Sigma"><i>sigma</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Percent"><i>percent</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Threshold"><i>threshold</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>.<b>CharThreshold</b>(<a href="HRegion.html">HRegion</a> <a href="#HistoRegion"><i>histoRegion</i></a>, double <a href="#Sigma"><i>sigma</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Percent"><i>percent</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#Threshold"><i>threshold</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HImage.html">HImage</a>.<b>CharThreshold</b>(<a href="HRegion.html">HRegion</a> <a href="#HistoRegion"><i>histoRegion</i></a>, double <a href="#Sigma"><i>sigma</i></a>, double <a href="#Percent"><i>percent</i></a>, out int <a href="#Threshold"><i>threshold</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>char_threshold</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#HistoRegion"><i>histo_region</i></a>: HObject, <a href="#Sigma"><i>sigma</i></a>: float, <a href="#Percent"><i>percent</i></a>: Union[int, float]) -&gt; Tuple[HObject, Sequence[int]]</code></p>
<p>
<code>def <b>char_threshold_s</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#HistoRegion"><i>histo_region</i></a>: HObject, <a href="#Sigma"><i>sigma</i></a>: float, <a href="#Percent"><i>percent</i></a>: Union[int, float]) -&gt; Tuple[HObject, int]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>The main application of <code><span data-if="hdevelop" style="display:inline">char_threshold</span><span data-if="c" style="display:none">char_threshold</span><span data-if="cpp" style="display:none">CharThreshold</span><span data-if="com" style="display:none">CharThreshold</span><span data-if="dotnet" style="display:none">CharThreshold</span><span data-if="python" style="display:none">char_threshold</span></code> is to segment single-channel
images of dark characters on bright paper.  该算子 works as follows:
First, a histogram of the gray values in the image <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a> is computed
for the points in the region <a href="#HistoRegion"><i><code><span data-if="hdevelop" style="display:inline">HistoRegion</span><span data-if="c" style="display:none">HistoRegion</span><span data-if="cpp" style="display:none">HistoRegion</span><span data-if="com" style="display:none">HistoRegion</span><span data-if="dotnet" style="display:none">histoRegion</span><span data-if="python" style="display:none">histo_region</span></code></i></a>{}.  To eliminate noise, the
histogram is smoothed with the given <a href="#Sigma"><i><code><span data-if="hdevelop" style="display:inline">Sigma</span><span data-if="c" style="display:none">Sigma</span><span data-if="cpp" style="display:none">Sigma</span><span data-if="com" style="display:none">Sigma</span><span data-if="dotnet" style="display:none">sigma</span><span data-if="python" style="display:none">sigma</span></code></i></a> (Gaussian smoothing).  In
the histogram, the background (white paper) corresponds to a large peak at
high gray values, while the characters form a small peak at low gray
values. In contrast to 该算子 <a href="binary_threshold.html"><code><span data-if="hdevelop" style="display:inline">binary_threshold</span><span data-if="c" style="display:none">binary_threshold</span><span data-if="cpp" style="display:none">BinaryThreshold</span><span data-if="com" style="display:none">BinaryThreshold</span><span data-if="dotnet" style="display:none">BinaryThreshold</span><span data-if="python" style="display:none">binary_threshold</span></code></a>
(with <code><span data-if="hdevelop" style="display:inline">Method</span><span data-if="c" style="display:none">Method</span><span data-if="cpp" style="display:none">Method</span><span data-if="com" style="display:none">Method</span><span data-if="dotnet" style="display:none">method</span><span data-if="python" style="display:none">method</span></code>=<i><span data-if="hdevelop" style="display:inline">'smooth_histo'</span><span data-if="c" style="display:none">"smooth_histo"</span><span data-if="cpp" style="display:none">"smooth_histo"</span><span data-if="com" style="display:none">"smooth_histo"</span><span data-if="dotnet" style="display:none">"smooth_histo"</span><span data-if="python" style="display:none">"smooth_histo"</span></i>), which locates  the
minimum between the two peaks, here the threshold for the segmentation is
determined in relation to the maximum of the histogram, i.e., the background,
with the following condition:
<span class="pre">

       histogram[threshold] * 100.0 &lt; histogram[maximum] * (100.0 - <a href="#Percent"><i><code><span data-if="hdevelop" style="display:inline">Percent</span><span data-if="c" style="display:none">Percent</span><span data-if="cpp" style="display:none">Percent</span><span data-if="com" style="display:none">Percent</span><span data-if="dotnet" style="display:none">percent</span><span data-if="python" style="display:none">percent</span></code></i></a>)

</span>
</p>
<p>For example, if you choose <a href="#Percent"><i><code><span data-if="hdevelop" style="display:inline">Percent</span><span data-if="c" style="display:none">Percent</span><span data-if="cpp" style="display:none">Percent</span><span data-if="com" style="display:none">Percent</span><span data-if="dotnet" style="display:none">percent</span><span data-if="python" style="display:none">percent</span></code></i></a> = 95 该算子 locates the
gray value whose frequency is at most 5 percent of the maximum
frequency. Because <code><span data-if="hdevelop" style="display:inline">char_threshold</span><span data-if="c" style="display:none">char_threshold</span><span data-if="cpp" style="display:none">CharThreshold</span><span data-if="com" style="display:none">CharThreshold</span><span data-if="dotnet" style="display:none">CharThreshold</span><span data-if="python" style="display:none">char_threshold</span></code> assumes that the characters are
darker than the background, the threshold is searched for “to the left” of
the maximum.
</p>
<p>In comparison to <a href="binary_threshold.html"><code><span data-if="hdevelop" style="display:inline">binary_threshold</span><span data-if="c" style="display:none">binary_threshold</span><span data-if="cpp" style="display:none">BinaryThreshold</span><span data-if="com" style="display:none">BinaryThreshold</span><span data-if="dotnet" style="display:none">BinaryThreshold</span><span data-if="python" style="display:none">binary_threshold</span></code></a>, this operator should be used if
there is no clear minimum between the histogram peaks corresponding to the
characters and the background, respectively, or if there is no peak
corresponding to the characters at all.  This may happen, e.g., if the image
contains only few characters or in the case of a non-uniform illumination.  </p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
    <li>Automatically parallelized on internal data level.</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>singlechannelimage(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte)</span>
</div>
<p class="pardesc">Input image.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="HistoRegion" class="parname"><b><code><span data-if="hdevelop" style="display:inline">HistoRegion</span><span data-if="c" style="display:none">HistoRegion</span><span data-if="cpp" style="display:none">HistoRegion</span><span data-if="com" style="display:none">HistoRegion</span><span data-if="dotnet" style="display:none">histoRegion</span><span data-if="python" style="display:none">histo_region</span></code></b> (input_object)  </span><span>region <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Region in which the histogram is computed.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Characters" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Characters</span><span data-if="c" style="display:none">Characters</span><span data-if="cpp" style="display:none">Characters</span><span data-if="com" style="display:none">Characters</span><span data-if="dotnet" style="display:none">characters</span><span data-if="python" style="display:none">characters</span></code></b> (output_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject *</span></span>
</div>
<p class="pardesc">Dark regions (characters).</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Sigma" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Sigma</span><span data-if="c" style="display:none">Sigma</span><span data-if="cpp" style="display:none">Sigma</span><span data-if="com" style="display:none">Sigma</span><span data-if="dotnet" style="display:none">sigma</span><span data-if="python" style="display:none">sigma</span></code></b> (input_control)  </span><span>number <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">float</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real)</span><span data-if="dotnet" style="display:none"> (<i>double</i>)</span><span data-if="cpp" style="display:none"> (<i>double</i>)</span><span data-if="c" style="display:none"> (<i>double</i>)</span></span>
</div>
<p class="pardesc">Sigma for the Gaussian smoothing of the histogram.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>2.0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0.0, 0.5, 1.0, 2.0, 3.0, 4.0, 5.0</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0.0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Sigma</span>
    <span data-if="c" style="display:none">Sigma</span>
    <span data-if="cpp" style="display:none">Sigma</span>
    <span data-if="com" style="display:none">Sigma</span>
    <span data-if="dotnet" style="display:none">sigma</span>
    <span data-if="python" style="display:none">sigma</span>
    
          ≤
          50.0</code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>0.01</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>0.2</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Percent" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Percent</span><span data-if="c" style="display:none">Percent</span><span data-if="cpp" style="display:none">Percent</span><span data-if="com" style="display:none">Percent</span><span data-if="dotnet" style="display:none">percent</span><span data-if="python" style="display:none">percent</span></code></b> (input_control)  </span><span>number <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Union[int, float]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">Percentage for the gray value difference.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>95</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>90, 92, 95, 96, 97, 98, 99, 99.5, 100</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0.0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Percent</span>
    <span data-if="c" style="display:none">Percent</span>
    <span data-if="cpp" style="display:none">Percent</span>
    <span data-if="com" style="display:none">Percent</span>
    <span data-if="dotnet" style="display:none">percent</span>
    <span data-if="python" style="display:none">percent</span>
    
          ≤
          100.0</code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>0.1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>0.5</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Threshold" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Threshold</span><span data-if="c" style="display:none">Threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">threshold</span><span data-if="python" style="display:none">threshold</span></code></b> (output_control)  </span><span>integer(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Calculated threshold.</p>
</div>
<div data-if="hdevelop" style="display:inline">
<h2 id="sec_example_hdevelop">例程 (HDevelop)</h2>
<pre class="example">
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
</pre>
</div>
<div data-if="c" style="display:none">
<h2 id="sec_example_c">例程 (C)</h2>
<pre class="example">
read_image(&amp;Image,"letters");
char_threshold(Image,Image,&amp;Seg,0.0,5.0,&amp;Threshold);
connection(Seg,&amp;Connected);
set_colored(WindowHandle,12);
set_shape(WindowHandle,"rectangle1");
disp_region(Connected,WindowHandle);
</pre>
</div>
<div data-if="cpp" style="display:none">
<h2 id="sec_example_cpp">例程 (HDevelop)</h2>
<pre class="example">
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
</pre>
</div>
<div data-if="com" style="display:none">
<h2 id="sec_example_com">例程 (HDevelop)</h2>
<pre class="example">
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
</pre>
</div>
<div data-if="dotnet" style="display:none">
<h2 id="sec_example_dotnet">例程 (HDevelop)</h2>
<pre class="example">
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
</pre>
</div>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="anisotropic_diffusion.html"><span data-if="hdevelop" style="display:inline">anisotropic_diffusion</span><span data-if="c" style="display:none">anisotropic_diffusion</span><span data-if="cpp" style="display:none">AnisotropicDiffusion</span><span data-if="com" style="display:none">AnisotropicDiffusion</span><span data-if="dotnet" style="display:none">AnisotropicDiffusion</span><span data-if="python" style="display:none">anisotropic_diffusion</span></a></code>, 
<code><a href="median_image.html"><span data-if="hdevelop" style="display:inline">median_image</span><span data-if="c" style="display:none">median_image</span><span data-if="cpp" style="display:none">MedianImage</span><span data-if="com" style="display:none">MedianImage</span><span data-if="dotnet" style="display:none">MedianImage</span><span data-if="python" style="display:none">median_image</span></a></code>, 
<code><a href="illuminate.html"><span data-if="hdevelop" style="display:inline">illuminate</span><span data-if="c" style="display:none">illuminate</span><span data-if="cpp" style="display:none">Illuminate</span><span data-if="com" style="display:none">Illuminate</span><span data-if="dotnet" style="display:none">Illuminate</span><span data-if="python" style="display:none">illuminate</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="connection.html"><span data-if="hdevelop" style="display:inline">connection</span><span data-if="c" style="display:none">connection</span><span data-if="cpp" style="display:none">Connection</span><span data-if="com" style="display:none">Connection</span><span data-if="dotnet" style="display:none">Connection</span><span data-if="python" style="display:none">connection</span></a></code>, 
<code><a href="select_shape.html"><span data-if="hdevelop" style="display:inline">select_shape</span><span data-if="c" style="display:none">select_shape</span><span data-if="cpp" style="display:none">SelectShape</span><span data-if="com" style="display:none">SelectShape</span><span data-if="dotnet" style="display:none">SelectShape</span><span data-if="python" style="display:none">select_shape</span></a></code>, 
<code><a href="select_gray.html"><span data-if="hdevelop" style="display:inline">select_gray</span><span data-if="c" style="display:none">select_gray</span><span data-if="cpp" style="display:none">SelectGray</span><span data-if="com" style="display:none">SelectGray</span><span data-if="dotnet" style="display:none">SelectGray</span><span data-if="python" style="display:none">select_gray</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="binary_threshold.html"><span data-if="hdevelop" style="display:inline">binary_threshold</span><span data-if="c" style="display:none">binary_threshold</span><span data-if="cpp" style="display:none">BinaryThreshold</span><span data-if="com" style="display:none">BinaryThreshold</span><span data-if="dotnet" style="display:none">BinaryThreshold</span><span data-if="python" style="display:none">binary_threshold</span></a></code>, 
<code><a href="auto_threshold.html"><span data-if="hdevelop" style="display:inline">auto_threshold</span><span data-if="c" style="display:none">auto_threshold</span><span data-if="cpp" style="display:none">AutoThreshold</span><span data-if="com" style="display:none">AutoThreshold</span><span data-if="dotnet" style="display:none">AutoThreshold</span><span data-if="python" style="display:none">auto_threshold</span></a></code>, 
<code><a href="gray_histo.html"><span data-if="hdevelop" style="display:inline">gray_histo</span><span data-if="c" style="display:none">gray_histo</span><span data-if="cpp" style="display:none">GrayHisto</span><span data-if="com" style="display:none">GrayHisto</span><span data-if="dotnet" style="display:none">GrayHisto</span><span data-if="python" style="display:none">gray_histo</span></a></code>, 
<code><a href="smooth_funct_1d_gauss.html"><span data-if="hdevelop" style="display:inline">smooth_funct_1d_gauss</span><span data-if="c" style="display:none">smooth_funct_1d_gauss</span><span data-if="cpp" style="display:none">SmoothFunct1dGauss</span><span data-if="com" style="display:none">SmoothFunct1dGauss</span><span data-if="dotnet" style="display:none">SmoothFunct1dGauss</span><span data-if="python" style="display:none">smooth_funct_1d_gauss</span></a></code>, 
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
